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MediSyn COM Interfaces 



Overview: 

The following is a list of the interfaces the COM component will support. Each of the 
following interface definitions is composed of the name, followed by the method description, the 
signature, the parameters and the return type. The table of contents lists each interface 
followed by their methods. Each method will have a brief description. The names of the methods 
within the table of contents are hyperlinks to the method description detail. 

The description will describe the functionality of the method. This will include any 
constraints or preprocessing information necessary to call this method. 

The signature, for the purposes of this document, is written using MS Visual Basic syntax. 
This facilitates readability for the developers on this project, as the middle tier component will be 
developed using MS Visual Basic. 

The parameter's names each parameter in the method call and gives a brief description of 
the purpose of the parameter. If the parameter has specific domain constraints, they will be 
noted in an indented small font beneath the parameter description. 

The return type will be consistent for each method. The return data type will be named, 
followed by the rules of what data will be returned. 

**note: All ADODB. Recordsets may be handled as 2 dimensional arrays, rather than a 
recordsest. 



Table of Contents 



IApplicant 
getApplicants 

newApplicant 
u pdateApplicant 

login 
logout 
getUser 
updateUser 

sendUserlnfo 



- Returns an applicant or a list representing all applicant 

records. 

- Inserts a new applicant record. 

- Sets Applicant flat as accepted/rejected. Flag to delete applicant 

record. 

- Allows MediSyn members to access the system securely. 

- Notifies MediSyn of user's departure. 

- Returns user information for admin use. 

- Updates user info if the user wishes to change login and/or 

password. 

- Sends user info to user if login or password is forgotten. 



INote 
getNotes 
getProgressNote 



Returns progress notes. 

Returns a progress note along with drug and problem lists. 



updateProgressNote - updates a progress note. 



IUtility 

findPatient - Returns a list of patients meeting search criteria. 

search - Returns a list of all matching entity records. 

getErrorMsg - Returns an error msg string when passed an error code. 



getCodeTable - Returns the specified code table. Used to populate dropdown 

lists. 

IProblem_Drugs 
getDrues - Returns list of drugs. 

updateDrugs - Updates prescriptions, including start date and end date and 

active flag. 

getProblems - Returns list of problems. 

updateProblems - Updates problems, including active flag. 

IEntity 

getEntity - Returns the specified entity's record. 

updateEntitv - Updates the specified entity's record. 

getPatientlnsurance - Returns patient insurance records. 
updatePatientlnsurance - Updates the patient's insurance information. 



IContact 

getAddresslnfo - Returns a list of address records for an entity. 

; undateAddresslnfo - Updates an entity's address record. 

[ getContactlnfo - returns a list of contact records for an entity. 

updateContactlnfo - Updates an entity's contact info record. 



IAccounting 

bill 

getBills 
records. 

getAcctsPavable 

proceessChecks 

processReceipts 

records. 

getReceipts 

updateDeposit 

getReconciliation 

updateReconciliation - 



Creates an AR records. 

Generates bills from AR records and returns a list of bill 

Returns a list of AP Records. 

Creates check records based on AP records. 

Creates receipt records which are applied to existing bill 

Returns a list of receipt records. 

Creates a deposit record based on existing receipt records. 
Returns deposit and check records that have not cleared. 
Updates deposit and check records that have cleared. 



COM Methods 



getApplicants 

Description: This method will return the specified applicant or all applicants in the applicant 1 
table. The number of records returned will be limited to 20. This will ensure that the web 
interface is not overwhelmed with hundreds of records. 



Signature: 

Public Function getApplicants(rsApplicants as ADODB.Recordset, 
Optional iApplicantld as Integer) as Long 



Parameters: 

rsApplicants: Contains applicant records. 
iApplicantld: specifies the applicant to be returned. 

The following columns are returned: Applicant Id, Entity Type, FName, LName, 
OrgName, Uniqueld, FEI_SSN, Phone, Fax, Email, Entity Type, UserName, Password. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

updateApplicants 

Description: 

This method will create a MediSyn user from an applicant and flag that applicant as accepted, or 
flag the applicant as denied if rejected. Once an applicant has been passed to updateApplicant 
their record in the applicant table is flagged as approved or denied and the date of the 
transaction is recorded. 60 days after this date, the record will be removed. The record will stay 
in the database for 60 days for auditing purposes. After that time, any issues with the applicant 
[ should have been resolved 

Signature: 

Public Function updateApplicants( iApplicantldO as Integer, _ 

Optional isApprovedO as Boolean ) as Long 

Parameters: 

iApplicantldO: Array, specifies the applicant to be updated. The isApproved flag will determine 

whether the applicant becomes a member of MediSyn. 
isApprovedo: If true a new MediSyn user is created and the applicant record is flagged as 

approved. If false the applicant record is flagged as denied. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

newApplicant 

Description: 

This method will create a new applicant and if the isApproved optional parameter = true, a new 
user. All of the parameters with valid data will be used to populate the applicant table and if the 
applicant is approved, the MediSynUser table, the corresponding entity table as specified by 
iEntityType, and the Contactjnfo table. 

Signature: 

Public Function newApplicant( sFName as String, _ 

sLName as String, _ 
sOrgName as String, 
sUniqueld as String, 
sFEI-SSN as String, - 






sPhone as String, _ 

sFax as String, _ 

sEMail as String, _ 

iEntityType as Integer, _ 

sUserName as String, _ 

sPassword as String, _ 

Optional iReferrer as Integer, _ 

Optional isApproved as Boolean ) as Long 



Parameters: 

sFName : Specifies the first name if the applicant is a doctor. 
sLName : Specifies the last name if the applicant is a doctor. 
sOrgName : Specifies the organization name if the applicant is not a doctor. 
sUniqueld : Specifies the unique identifier for the entity being added. UPIN for doctor, license 
forPharmacy. 

sFEI SSN : Specifies the SSN or FEI for the entity being added. 
sPhone : Specifies the phone number for the entity being added. 
sFax : Specifies the fax number for the entity being added. 
'sEMail : Specifies the email address for the entity being added. 
'iEntityType : Specifies the entity type for the entity being added. 
sUserName : Specifies the user name for the entity being added. 
I sPassword : Specifies the password for the entity being added. 

j iReferrer : Specifies the doctor _id of the doctor who will be the parent id for the doctor being 
J added. 

1 isApproved: If true a new MediSyn user is created and the applicant record is deleted. If false the 
applicant record is deleted. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 



Parameters: 

sLogin: Specifies the username of the applicant. This value cannot contain <space> characters 
and must be a minimum of 6 and a maximum of 15 characters in length. 

sPassword: Specifies the password of the applicant. This value cannot contain <space> 

characters and must be a minimum of 6 and a maximum of 15 characters in length. It 



login 



Description: 

The login method provides a mechanism for MediSyn users to access the application. 



Signature: 

Public Function login(sLogin as String, _ 



sPassword as String, _ 
sIP_Address as String, _ 
ByRef iEntityType as Integer, _ 
ByRef iEntityld as Integer) as Long 



# • 

must also contain at least one uppercase and one lowercase letter and at least one 

numeric character. 
sIP_Address: Specifies the IP Address of the user attempting to login. 
iEntityType: The type of entity of the user logging in. This is returned to the caller. 
iEntityld: The id of entity of the user logging in. This is returned to the caller. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

logout 

Description: 

The logout method provides a mechanism to inform MediSyn that a user has left the application. 
This is used for logging purposes. By noting the date, time and location of the login attempt, the 
application can track when and what lengths of time users have used the system. 

Signature: 

Public Function logout(ByVal iEntityld as Integer, _ 

ByVal iEntityType as Integer ) as Long 

^ Parameters: 

i iEntityld: Specifies the id of the entity logging out. 
I iEntityType: Specifies the type of user logging out. 

1 Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 
getUser 
\ Description: 

1 This method will return the specified user from the MediSynUser table. Administrators will use 
this method when a user forgets their login or password and they do not have an email address. 

Signature: 

Public Function getUser(ByVal iEntityType as Integer, 

sUniqueld as String, _ 
sLogin as String, _ 
sPassword as String ) as Long 

Parameters: 

iEntityType: Specifies the entity whose info is to be sent 

sUniqueld: Specifies the unique identifier for the type of user defined by iEntityType above. 

Examples: Doctor - UPIN, Pharmacy - License, FEI - Hospital. 
sLogin - Where the user's login name is returned. 
sPassword - Where the user's login name is returned. 



Return type: 



Long: returns 0 if successful and an Error Code if unsuccessful. 



updateUser 
Description: 

This method updates user info to allow the user to change their login name and/or password. 
Signature: 

Public Function updateUser(ByVal iEntityld as Integer, _ 

ByVal iEntityType as Integer, _ 
Optional sUserName as String, _ 
Optional sPassword as String ) as Long 

Parameters: 

iEntityld: Specifies the entity whose info is to be updated. 
iEntityType: Specifies the entity whose info is to be updated 
sUserName: Specifies the new username 
sPassword: Specifies the new password. 

[ Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

sendUserlnfo 

Description: 

This method gets user info and sends the user their login name and password via email. This 
provides the same functionality as getUser, except that it does not require the administrator's 
involvement. 

Signature: 

Public Function sendUserInfo(ByVal iEntityType as Integer, _ 

sUniqueld as String ) as Long 

Parameters: 

iEntityType: Specifies the entity whose info is to be sent 

sUniqueld: Specifies the unique identifier for the type of user defined by iEntityType above. 
Examples: Doctor - UPIN, Pharmacy - License, FEI - Hospital. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

getNotes 

Description: 

This method allows the interface to receive all of the progress notes for a physician, patient, 
drug, or problem. The collection of notes returned is determined by the iNoteType parameter. 
This value will resolve to referred notes, open notes, problem notes, or drug notes. 



Signature: 

Public Function getNotes(ByVal iEntityld as Integer, _ 

iNoteType as Integer, 
rsEntity Notes as ADODB_Recordset, _ 
Optional iDrug_Problem as Integer ) as Long 

Parameters: 

iEntityld: Specifies the doctor who is logged into the system. If iNoteType = 1 or 2, the iEntityld 

points to doctor _id. If iNoteType = 3 or 4, the iEnftyld points to patient id 
iNoteType: Specifies the progress notes to return. 

1 -referred notes 

2 - open notes 

3 - drug notes 

4 - problem notes 

rsReferringNotes: An ADO Recordset which will contain all of the progress notes where 
iDoctorld is the referring doctor id. 

iDrug Problem: This field will contain the drug id or problem id if the iNoteType is 3 or 4 
respectively. 

The following columns are returned: note_id, patient.first_name, patient.last_name, 
note_date, note_time, ctor.first_name, doctor.last_name 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

getProgressNote 

Description: 

The two dimensional array or ADODB.Recordset, rsProgressNote, returned will contain the 
fields in the progress note identified by iNoteld. The two dimensional array or 
ADODB.Recordset, rsDrugs, returned will contain the drug records associated with the progress 
notes identified. The two dimensional array or ADODB.Recordset, rsProblem, returned will 
contain the problems associated with the progress note identified. 

Signature: 

Public Function getProgressNote(ByVal iNoteld as Integer, _ 

rsProgressNote as ADODB.Recordset, _ 
rsDrugs as ADODB.Recordset, 
rsProblems as ADODB.Recordset ) as Long 

Parameters: 

iNoteld: Specifies the patient for whom the demographic information is requested. 
rsProgressNote: An ADO Recordset which will contain the referenced progress note. 

The following columns are returned: note„id, note_date, note_time, doctor_id, note, 
referring_Doctor, valid, transcript_id. 



rsDrugs: An ADO Recordset which will contain those drugs referenced in the progress note. 

The following columns are returned: drug_id, description, isActive. 

rsProblems: An ADO Recordset which will contain those problems referenced in the the 
referenced progress note. 

The following columns are returned: problem_id, description, isActive. 
Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

updateProgressNote 

Description: 

Adds or updates a progress note for an existing patient and doctor. If the iNoteld parameter is 0, 

then the progress note is coming from the transcription service and is to be inserted into the 
" Progress _Note table. If the iNoteld parameter > 0, then the note is being validated by the doctor 
; and will be updated with the problems and drugs associated with the note. Also, a progress note 

may only be updated once. At that time the valid flag is set to true and the record can no longer 

be modified. 

Signature: 

Public Function updateProgressNote (ByVal iPatientld as Integer, 

ByVal iNoteld as Integer, 
ByVal iDoctorld as Integer, 
ByVal iTranscriptionld as Integer, 
sNoteDate as String, 
sNoteText as String, 
Optional aProblemsO as Variant, 
Optional aDrugsO as Variant, 
Optional sNoteTime as String, 
Optional ByVal iRefDoctorld as Integer) as Long 

Parameters: 

iPatientld: Specifies the patient referenced in the progress note. 

iNoteld: Specifies the note id of the progress note. If this value is zero, then a new progress note 
is created. 

iDoctorld: Specifies the doctor referenced in the progress note. 

iTranscriptionld: Specifies the transcription service referenced in the progress note. 

sNoteDate: Specifies the date of the progress note. 

sNoteText: Specifies the text of the progress note. 

aProblems: Two-dimensional array specifying the problems in the note. The columns are 

problemld, description, active. If the problemld is 0, then the problem is inserted into the 
problem table. All problems should be tagged to the progress note for future reference. 



aDrugs: Two-dimensional array specifying the Drugs in the note. The columns are Drugld, 

description, active. If the Drugld is 0, then the drug is inserted into the drugs table. This 
array does not have to contain data. There may or may not be a prescription associated 
with a progress note. All drugs should be tagged to the progress note for future reference. 

sNoteTime: Specifies the time of the progress note. 

iRefDoctorld: Specifies the referring physician for the progress note. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

findPatient 

Description: 

The two dimensional array or ADODB. Recordset returned will contain the patient's name, SSN 
and DOB. This will be presented to. the user as a hyperlink to view the patient's 
problem(diagnosis) and drug(prescription) lists. At least one of the fields is required to have a 
value. 

J Signature: 

; Public Function findPatient(rsPatients as ADODB. Recordset, 

Optional sFName as String, _ 
Optional SLName as String, _ 
Optional sSSN as String, _ 
Optional sDOB as String) as Long 

Parameters: 

rsPatients: An ADO Recordset which will contain all of the patient records that matched the 
search criteria. 

sFName: Specifies the first name of the patient being searched. 
sLName: Specifies the last name of the patient being searched. 
sSSN: Specifies the SSN of the patient being searched. 
sDOB: Specifies the DOB of the patient being searched. 

The following columns are returned: patient_id, patient. first_name, patient. last_name, 
patient_ssn„ patient_dob, doctor_id. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

search 

Description: 

The two-dimensional array or ADODB.Recordset returned, will contain a list of all records that 
matched the search criteria. 

Signature: 

Public Function search(ByVal iEntityType as Integer, _ 



rsSearch as ADODB.Recordset 
Optional sName as String, _ 
Optional sFName as String, 
Optional sLName as String, _ 
Optional sCity as String, _ 
Optional sZip as String ) as Long 

Parameters: 

iEntityType: Specifies the type of entity to be searched, shame: Specifies the organization name 
of the entity to be searched. This valid when searching on any entity except doctors. 

sFName: Specifies the first name of the entity to be searched. This is only valid when searching 
for doctors. 

sLName: Specifies the last name of the entity to be searched. This is only valid when searching 
for doctors. 

sCity: Specifies the city of the entity to be searched. 

sZip: Specifies the zip code of the entity to be searched. 

rsSearch: An ADO Recordset which will contain all matches for the search. 

The following columns are returned: name, entity_id, entity_type, fNarne, LName, City, 
StateCode, zip. 

= Return type: 

i Long: returns 0 if successful and an Error Code if unsuccessful. 
i getErrorMsg 
Description: 

This method will select the Error Message from the database and return it to the calling 
program. The return value is a string; which can be displayed to the user in the form of a 
message/alert window. 

Signature: 

Public Function getErrorMsg(ByVal lErrorCode, _ 

rsErrorMsg as ADODB.Recordset) as Long 

Parameters: 

lErrorCode: Specifies the error in the database. 
rsErrorMsg: Recordset to contain the returned error data. 

The following columns are returned: code_id, code_description 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

getCodeTable 

Description: 




This method will return all records from the specified code table. 
Signature: 

Public Function getCodeTable(sCodeTable as String, _ 

rsCodeTable as ADODB.Recordset) 

Parameters: 

sCodeTable: Specifies the code table to be returned. 

rsCodeTable: Specifies a recordset containing the ids and names of the fields in the code table 
specified. 

The following columns are returned: Field_Id, Field_Name. 
Return type: 

Integer: returns positive if successful and 0 or negative if unsuccessful. 

getDrugs 

Description: 

The two dimensional array or ADODB.Recordset returned will contain the specified entity's drug 
list. 

Signature: 

Public Function getDrugs(ByVal iEnityld as Integer, _ 

ByVal iEntityType as Integer, _ 
rsDrugs as ADODB.Recordset) as Long 

Parameters: 

iEntityld: Specifies the entity for whom the drug fist is requested. 

iEntityTYpe: Specifies the entity type of the entity for whom the drug list is requested. 

rsDrugs: An ADO Recordset which will contain all of the prescription records linked to a patient. 

The following columns are returned: prescriptionjd, description, doctor_id, isActive. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

updateDrugs 

Description: 

This method updates the progress__prescription table with the start_date, end_date. 
Signature: 

Public Function updateDrugs(ByVal iPrescriptionld as Integer, _ 

sStartDate as String, _ 
sEndDate as String 

Optional ByVal iPharmacistld as Integer, - 



Optional isActive as Boolean ) as Long 

Parameters: 

iPrescriptionld: Specifies the drug record being updated 
sStartDate: Specifies the prescription starting date. 
sEndDate: Specifies the prescription ending date. 

iPharmacyld: Specifies the pharmacy for whom the drug list is requested. 
isActive: Specifies whether the drug is actively used. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 
getProblems 

The two dimensional array or ADODB.Recordset returned will contain the specified entity's 
problem(diagnosis) fist. 

Signature: 

Public Function getProblems(ByVal iEntityld as Integer, _ 

ByVal iEntityType as Integer, _ 
rsProblems as ADODB.Recordset) as Long 

Parameters: 

iEntityld: Specifies the enitity for whom the problem list is requested. 
iEntityTYpe: Specifies the type of the entity for whom the problem list is requested. 
rsProblems: An ADO Recordset which will contain all of the problem records finked to a patient. 

The following columns are returned: problem_id, description, doctor_id, isActive. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

updateProblems 

Description: 

This method updates the progress ^problem table with the active flag. 
Signature: 

Public Function updateProblem(ByVal iProblemld as Integer, _ 

isActive as Boolean ) as Long 

Parameters: 

iProblemld: Specifies the problem being updated. 
isActive: Determines whether the problem is actively used. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 




sretEntitv 
Description: 

The two dimensional array or ADODB.Recordset returned will contain the fields in the entity- 
table corresponding to the entity and entity type passed. 

Signature: 

Public Function getEntity(ByVal iEntityld as Integer, _ 

ByVal iEntityType as Integer, _ 
rsEntity as ADODB.Recordset) as Long 

Parameters: 

iEntityld: Specifies the entity requested. 

iEntitytype: Specifies the type of entity requested. 

rsEntity: An ADO Recordset which will contain the referenced entity. 

The following columns are returned: all fields from the specified entityType table. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

updateEntity 

Description: 

This method is used to insert or update an entity record. 
Signature: 

Public Function updateEntity(Byval iEntityld as Integer, _ 

ByVal iEntityType as Integer, _ r 

Optional sFName as String, - 

Optional sLName as String, _ 

Optional sOrgName as String, - 

Optional sDOB as String, _ 

Optional sSSN_FEI as String, _ 

Optional sUPIN_Lic as String, 

Optional iDoctor as Integer ) as Long 

Parameters: 

iEntityld: Specifies the entity whose record is being updated. If iEntityld = 0 the it specifies that 

the entity is to be inserted. 
iEntityType: Specifies the entity type of the entity whose record is being updated/inserted. 
sFName: Specifies the first name of the entity being inserted/updated. 
sLName: Specifies the last name of the entity being inserted/updated. 
sOrgName: Specifies the organization name of the entity being inserted/updated. 
sDOB: Specifies the DOB of the entity being inserted/updated. 
sSSNJFEI: Specifies the SSN or FEI of the entity being inserted/updated. 



sUPINJLic: Specifies the UPIN or License of the entity being inserted/updated. License for 

pharmacy, UPIN for doctor, license for Pharmacy. 
iDoctor: Specifies the parent doctor when inserting a doctor. Specifies the doctor for a patient 

when inserting a doctor record. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

getPatientlnsurance 

Description: 

The two dimensional array or ADODB.Recordset returned will contain the insurance information 
for the specified patient. Multiple records may be returned where each record 

Signature: 

Public Function get Patient Insurance (ByVal iPatientld as Integer, _ 

rslnsurance as ADODB.Recordset) as Long 

O Parameters: 

Jjg iPatientld: Specifies the patient whose insurance is requested. 

£\ rslnsurance: An ADO Recordset which will contain the patient's insurance information. Each 
Ifi row will contain an insurance record for the patient. 

SJ The following columns are returned: insurance_id, policy, name, FEI 

1, Return type: 

r*! Long: returns 0 if successful and an Error Code if unsuccessful. 

t : 

V updatePatientlnsurance 

O Description: 

Adds or updates an Insurance record for an existing patient. 

Signature: 

Public Function updatePatientInsurance(ByVal iPatientld as Integer, _ 

ByVal ilnsurance Id as Integer, - 
Optional sPolicy as String, _ 
Optional sName as String, _ 
Optional sFEI as String ) as Long 

Parameters: 

iPatientld: Specifies the patient for whom the insurance information is requested, 
ilnsuranceld: Specifies the Insurance company inserted/updated for the patient. If the value for 

ilnsurancejd = 0, then this method will insert a new insurance company record. 
sPolicy: Specifies the policy number for the insurance company and patient. 
sName: Specifies the name of the Insurance company that is being inserted/updated 
sSFEI: Specifies the FEI for the Insurance company being inserted/updated. 



Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

getAddressInfo 

Description: 

The two dimensional array, or ADODB. Recordset returned will contain the address information 
for the entity being passed. Each record will represent one address type for the entity. An entity 
may have 0 to many address records, but each one will have a different address type. 

Signature: 

Public Function getAddressInfo(ByVal iEntityld as Integer, _ 

ByVal iEntityTypeld as Integer, _ 
rsAddressInfo as ADODB. Recordset) as Long 

Parameters: 

^ iEntityld: Specifies the entity whose address is requested. 

5 iEntityTypeld: Specifies the entitytype of the entity whose address is requested. 

2f rsAddressinfo: An ADO Recordset which will contain the referenced entities address records. 

'm The following columns are returned: name, addressType_id, addressl, address2, city, 

ftj state Code, zip, country. 

ff 1 Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

y[ u pdateAddressinfo 

O Description: 

□ This method will insert or update an address record for the specified entity. If the address type 
parameter passed is not equal to the address type field in the address table for that entity and 
entity type, then a new address record will be created. If not, the address record identified by the 
three passed fields will be updated. 

Signature: 

Public Function updateAddressInfo( 

ByVal iEntityld as Integer, _ 
ByVal iEntityTypeld as Integer, _ 
ByVal iAddressTypeld as Integer, _ 
Optional sAddressl as String, 
Optional sAddress2 as String, _ 
Optional sCity as String, 
Optional sStateCode as String, _ 
Optional sZip as String, 
Optional sCountry as String ) as Long 

Parameters: 



iEntityld: Specifies the entity id of the entity whose address is being inserted/updated. 
iEntityTypeld: Specifies the type of entity whose address is being inserted/updated. 
iAddressTypeld: Specifies the address type of the entity whose address is being 

inserted/updated. If this value is not equal to an existing address record, then the address 

record is an insert. If not it is an update. 
sAddressl : Specifies the first line of the address of the entity whose address is being 

inserted/updated. 

sAddress2: Specifies the second line of the address of the entity whose address is being 
inserted/updated. 

sCity: Specifies the city of the entity whose address is being inserted/updated. 
sStateCode: Specifies the state of the entity whose address is being inserted/updated. 
sZip: Specifies the postal code of the entity whose address is being inserted/updated. 
sCountry: Specifies the country of the entity whose address is being inserted/updated. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 
getContactlnfo 
] Description: 

The two dimensional array or ADODB. Recordset returned will contain the contact information 
i for the entity being passed. Each record will represent one contact type for the entity. An entity 
1 may have 0 to many contact records, but each one will have a different contact type. 

Signature: 

Public Function getContactInfo(ByVal iEntityld as Integer, _ 
ByVal iEntityTypeld as Integer, _ 
rsContactlnfo as ADODB.Recordset) as Long 

Parameters: 

iEntityld: Specifies the entity whose contact info is requested. 

iEntityTypeld: Species the entitytype of the entity whose contact info is requested. 

rsContactlnfo: An ADO Recordset which will contain the referenced entities contact information. 

The following columns are returned: contact_type, value. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

updateContactlnfo 

Description: 

This method will insert or update a contact record for the specified entity. If the contact type 
parameter passed is not equal to the contact type field in the contact table for that entity and 
entity type, then a new contact record will be created. If not, the contact record identified by the 
three passed fields will be updated. 



Signature: 

Public Function updateContactInfo( 

ByVal iEntityld as Integer, _ 
ByVal iEntityTypeld as Integer, _ 
ByVal iContactTypeld as Integer, - 
Optional sValue as String ) as Long 

Parameters: 

iEntityld: Specifies the entity id of the entity whose address is being inserted/updated. 
iEnftyTypeld: Specifies the type of entity whose address is being inserted/updated. 
iContactTypeld: Specifies the address type of the entity whose address is being 

inserted/updated. If this value is 0 then the address record is an insert. If not it is an 

update. 

sValue: Specifies the value of the contact type for the entity whose contact is being 
inserte d/up date d. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 
bill 

Description: 

This method is called after a patient's record is accessed, where the patient's doctor_id is not 
equal to the doctor_id of the current user, or the current user is not a doctor. This method is 
called after a progress note record is accessed where the progress note's doctor_id is not equal to 
the doctor_id of the current user, or the current user is not a doctor. 

Signature: 

Public Function bill( ByVal iEntityld as Integer, _ _ 

ByVal iEntityType as Integer, _ 
ByVal iTransactionType as Integer ) as Long 

Parameters: 

iEntityld: Specifies an array of entity id of the entities being billed. 
iEntityTypeld: Specifies an array of entityType ids of the entity being billed. 
iTransactionType: Specifies the transaction type; patient access, note access, pharmaceutical 
report. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

get Bills 

Description: 

This method will first get all bill records that are over 30 days old and do not have a receipt 
record. An AR transaction of type, aged receivables, will be created in the amount of 10% of the 
bill amount. The bill will then be updated with the new amount, based on the original bill 



amount plus the new transaction amount. This method will then get all AR records that do not 
have a bill (batch) number, group them by entityld and entityType, and sum them on amount. 
These groups will then be inserted as new bill records. Each of these bill records, including all 
newly created and all updated bill will be returned. If the bDetail flag is true, all corresponding 
AR records that make up each bill will also be returned 

Signature: 

Public Function getBills(rsBills as ADODB.Recordset 

bDetail as Boolean ) as Long 

Parameters: 

rsBills: Contains a list of Bill records, grouped by entityJD and entity-type 

The following columns are returned: Entityld, EntitytypelD, EntityFName, EntityLName, 
EntityOrgName, BillJDate, Amount, Tran_Date, TranJType, Acct_JRec.Amount. 

bDetail: Specifies whether the returned recordset will contain A/R records or just bill (summary) 
records. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

getAcctsPayable 

Description: 

This method will return all AP records that do not have a check (batch) number. 
Signature: 

Public Function getAcctsPayable (rsAP as ADODB.Recordset) as Long 
Parameters: 

rsAP: Contains a list of AP records, grouped by entityJD and entity_type 

The following columns are returned: Entityld, EnftytypelD, EntityFName, EnffcyLName, 
EntityOrgName, Tran_Date, Tran_Amount. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

processChecks 

Description: 

This method will create a check record and update the AP record with the batch number of the 
created check. 

Signature: 

Public Function processChecks(iEntity!dO as Integer, 




iEntityTypeldO as Integer, _ 
vCheckDateO as Variant, _ 
iCheckNumberO as Integer, 
vCheckAmountO as Variant ) as Long 

Parameters: 

iEntityldO: Specifies an array of entity id of the entities whose check records are being updated. 
iEntityTypeldO: Specifies an array of entityType ids of the entities whose check records are being 
updated. 

vCheckDate: Specifies an array of the dates of the check records being updated. 
ICheckNumber: Specifies an array of the check numbers of the check records being updated. 
vCheckAmount: Specifies an array of the amounts of the check records being updated. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

processReceipts 

Description: 

This method will update the Payment Received table with payments amounts and dates for the 
corresponding bills. 

Signature: 

Public Function processReceipts(iEntityId() as Integer, _ 

iEntityTypeldO as Integer, _ 
vRecDateO as Variant, 
vRecAmountO as Variant ) as Long 

Parameters: 

iEntityldo: Specifies an array of entity id of the entities whose bills are being paid. 
iEntityTypeldO: Specifies an array of entityType ids of the entities whose bills are being paid. 
vRecDate: Specifies an array of the dates of the receipts for the bills that were paid. 
vRecAmount: Specifies an array of the amounts of the receipts for the bills that were paid. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

getReceipts 

Description: 

This method will return all Payment Received records where there is no Deposit id. 
Signature: 

Public Function getReceipts(rsReceipts as ADODB.Recordset) as Long 
Parameters: 

rsReceipts: Contains a list of Payment Received records. 



The following columns are returned: Entityld, EntitytypelD, EntityFName, EnftyLName, 
EnftyOrgName, ReceiptID, Receipt_Date„ Amount. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

updateDeposit 

Description: 

This method will create a deposit record and update the receipt records included on that deposit 
with the deposit id. 

Signature: 

Public Function updateDeposit(iReceiptId() as Integer, _ 

sDepDate as String, _ 
sDepTicketld as String ) as Long 

Parameters: 

iReceiptld: Specifies an array of Receipts to be updated with the deposit id. 

sDepDate: Specifies the date of the deposit. 

sDepTicketld: Specifies the deposit ticket id for the deposit. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

getReconciliation 

Description: 

This method will return all deposits records with no clear_date and all checks with no 
check_clear_date . 

Signature: 

Public Function getReconciliation(rsChecks as ADODB.Recordset, _ 

rsDeposits as ADODB.Recordset ) as Long 

Parameters: 

rsChecks: Contains check records where there is no check-clear-date for that check. 

The following columns are returned: Entity Jd, EntityJType, CheckJDate, 
Check_Number, Check_Amount. 

rsDeposits: Contains deposit records where there is no clear date for that deposit. 

The following columns are returned: Entityjd, EntityJType, DepositJDate, 
Deposit_Amount. 



Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 

updateReconciliation 

Description: 

This method will update the checks table with a check_clear_date for checks that clear and 
updates the deposit table with a clear_date for deposits that clear. 

Signature: 

Public Function updateReconciliation(iBatch() as Integer, _ 

vCheckAmountO as Variant, _ 
sCheckDateO as String, _ 
iDepositlDO as Integer, _ 
vDepositAmountO as Variant, _ 
sDepositDateO as String ) as Long 

Parameters: 

iBatchO: Array of check batch numbers. Each item in the array corresponds to a check amount 

and dates in the vCheckAmount array and the sCheckDate array. 
vCheckAmountO: Specifies an array of check amounts being reconciled. 

sCheckClearDateO: Specifies an array of the dates those checks cleared on the bank statement. 
iDepositldO: Specifies an array of deposit ids being reconciled. 
vDepositAmountO: Specifies an array of the deposit Amounts being reconciled. 
sDepositClearDateO: Specifies an array of the dates those deposits cleared on the bank 
statement. 

Return type: 

Long: returns 0 if successful and an Error Code if unsuccessful. 
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